This function converts the date and time of data type DTL to the UNIX time of data type DInt. The timestamp is calculated in UTC. This means that the time zone is not considered.
Only times after 01/01/1990 are permitted.
| LGF_DTLToUnixTime (FC) | ||||||||
|---|---|---|---|---|---|---|---|---|
| DTL | timeDTL | Ret_Val | DInt | |||||
| error | Bool | |||||||
| status | Word | |||||||
| Identifier | Data type | Description |
|---|---|---|
| timeDTL | DTL | Date and time as DTL to convert to UNIX time |
| Identifier | Data type | Description |
|---|---|---|
| Ret_Val | DInt | Converted UNIX time |
| error | Bool | FALSE: No error TRUE: An error occurred during the execution of the FB |
| status | Word | 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
| Code / Value | Identifier / Description |
|---|---|
| 16#0000 | STATUS_EXECUTION_FINISHED_NO_ERROR Execution finished without errors |
| 16#8000 | ERR_TIME_BEFORE_1990 Error: Input time is before 01/01/1990. The function does not support this conversion, because of internal used datatype |
| 16#8001 | ERR_DTL_INPUT_VALUE_INVALID Error: Input timestamp value not valid. The data type contains implausible data. |
| Version & Date | Change description | |
|---|---|---|
| 1.0.0 | Siemens Industry Online Support | |
| 16.10.2018 | First released version | |
| 1.0.1 | Simatic Systems Support | |
| 20.06.2019 | Standard header and block parameters update, status parameter added | |
| 1.0.2 | Simatic Systems Support | |
| 10.07.2019 | Commends added and code refactoring Add ENO handling | |
| 3.0.0 | Simatic Systems Support | |
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library | |
| 3.0.1 | Simatic Systems Support | |
| 23.02.2021 | Insert documentation | |
| 3.0.2 | Simatic Systems Support | |
| 14.04.2023 | Improve data verification for input `timeDTL` for valid data | |